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I. INT RODOC TIO H 



The analysis of requirements has been, and continues to 
be, a source of difficulty in developing software. The 
impact of improper analysis is far reaching. Consequently, 
considerable effort has been put into developing 
methodologies to elicit and accurately capture what is 
needed and wanted. The traditional strategy for conducting 
requirements analysis has been to interview users 
individually and then to document, in ordinary English, the 
users' needs. The result of this process is a large tome of 
requirements that is seldom understood in its entirety. 
However, requirements analysis is the foundation effort for 
any software system and therefore of particular importance 
for achieving project success. The foundation is provided 
by uncovering the flow and structure of data. 

The software to be built it described by several 
completion of several actions. Design constraints must be 
identified to bound the problem and clarify its scope. 
Functions and data must be described to permit an 
understanding of the essence of the system to be automated. 
Interface details for hardware, software, human beings and 
procedures must be developed to integrate the software into 
the encompassing system or organization. Important to 
describing the software is establishing and maintaining 
communications with both the eventual user and the 
originating requestor. The information flow and structure 
becomes a tool that leads to an overall representation of 
the software which will be developed. Thus, the design 
process is fed the output of the requirements analysis 
effort. The continuity of the effort and the quality of the 
design are heavily dependent on the requirement 
specification. [Ref. 1] 
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There are several problems with the requirement analysis 
effort as exercised in the traditional software life cycle. 
First, users* needs may change significantly during 
development. This can occur through a natural evolution of 
the organization or through interaction with the software 
development effort. Secondly, the user has no system during 
the period between the solicitation of requirements and 
delivery of the completed system. The user has no clear 
picture of what he will be getting because he has only been 
dealing with abstract terms and representations, nothing 
that actually behaves like the real system. [Bef. 2] 

The reasons for some of these problems are known. The 
people involved do not share the same frames of reference 
because analysts and end-users coma from different cultures. 
An analyst can be viewed as a missionary steeped in computer 
technology. An end-user is only concerned with getting the 
job done within his particular business area. The two 
usually do not understand each ethers* area of expertise and 
a great deal of learning, particularly for the analyst, must 
take place. The product resulting from the interaction of 
an analyst and a user is often a document of which too much 
is expected. The medium of a textual document may capture 
many relevant details, but it may not in turn communicate 
them with sufficient clarity to permit true understanding. 

A specification document is often too long; contains 
technical terms the user does not know; contains words with 
different meaning to users and analysts and often also 
contains trivia and motherhood statements which sound good 
but offer no real benefit. A textual specification can be 
particularly lacking regarding interactive systems because a 
document cannot capture the dynamic quality of the user 
interaction. 

Nevertheless, the textual document as a requirement 
specification is the basis for all follow on work. This 



work cannot be correct if its basis is inaccurate. Despite 
users not always understanding the specifications, they are 
often coerced into signing and approving the document 
because the developers refuse tc go forward without a 
signature. The developers feel it is necessary to have user 
approval and the requirements frozen to prevent having to 
make changes which increase system cost further along in the 
development process. However, the freezing of requirements 
specifications causes apprehension for both users and 
developers. Developers either intuitively feel or know from 
experience that the act of providing what an end-user needs, 
and the follow on design and coding effort, changes his 
perception of those needs. The solution to a problem can 
change the problem [fief. 3]. The essence of the problem of 
inadequate requirement specif ications is the incomplete 
communications between the user and the analyst. The 
evidence that inadequate communications is still a problem 
lies in the fact that software software development projects 
still suffer from poorly defined specif ications despite the 
considerable effort that has been expended in in developing 
and using rigorous methodologies. Some observers feel the 
failure rate is just as high as it was 15 years ago and that 
most development is a trial and error process [fief. 4]. 

Requirements specifications can take one of three forms. 
The traditional approach is to develop a textual list of 
"shall statements" the system must fulfill. A major 
disadvantage of the textual approach is the psychological 
distance from what the user will eventually receive. A 
document does not convey a realistic sense of how the system 
will fit the user' s needs. This is especially true for 
interactive systems. Textual specifications take a static 
view in attempting to capture or freeze the situation. Most 
users cannot fully describe their current requirements and 
even fewer can identify their future needs. A more recent 
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innovation is the use of an interpretive model. An example 
of this approach is the Structured Analysis Design Technique 
which uses a set of graphical representations. Other 
interpretive modeling techniques are the use of data flow 
diagrams, flowcharts and Nassi-Schneidermann charts. These 
approaches, although an improvement over the textual, still 
do not adequately communicate on line-interaction. Dsing 
more detailed graphics places mere burden on the users than 
it helps. However, users know what would be useful if they 
saw it £Bef. 5]. A useful approach is to develop a working 
model, a prototype. The development of higher level 
languages and the lessening cost of hardware have recently 
given rise to a requirements analysis approach which offers 
promise of assisting in the communications problem. This 
technique is prototyping. 

Chapter 2 is devoted to explaining the concept of 
prototyping. A key to successful prototyping, if not all 
systems analysis, is the capture of data about the data in 
some form. Data dictionaries are the means most often used 
for organizing this "metadata". Chapter 3 will discuss 
metadata and data dictionaries and their potential role in 
the system analysis and design process. By explaining 
prototyping and data dictionaries we will show the two as an 
inseparable pair which are an important adjunct to the 
system development process. The culmination of this thesis 
is chapter 4 wherein we develop a general, relational-based 
design of a data dictionary for use with prototyping for 
requirements analysis. This dictionary will be implemented 
using dbase II, a micro-oriented relational database 
management system. 
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II. PBOTOTYPIMG FOB SO^BIBE EIQUIfiEMENTS 



A. DEFINITIOH OF PBOTOTYPING 

Webster's dictionary defines a prototype as one of 
three possible things: 

1. An original or model after which anything is formed 

2. The first thing of its kind 

3,. A pattern, an exemplar, an archetype 
The second definition is probably the most relevant to this 
discussion because prototypes are being used in data 
processing as a first attempt at a design which is then 
extended or enhanced. In general systems development, a 
prototype is known as 

"...a partially complete functional model of a target 
system whose purpose is to provide a better under- 
standing of the target system's requirements" [Bef- 6]. 

A software prototype is characterized by the following 
features. It is a working system, although of limited 
capability, rather than just an idea on paper. A prototype 
may become, after iterative enhancement, a production 
system. Its original purpose is to test out assumptions 
about requirements and/or system design architecture. A 
prototype is created quickly. This has become possible only 
in recent years with more powerful languages which are less 
procedurally oriented. Some would argue however, that 
prototyping was the way software was developed before the 
advent of functional decomposition and the system 
development life cycle which is generally accepted and used 
todti . 
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€ development writing 
After an explanation of 
tions and answers, and 
Its of a method, the 
ork. Starting with that 
as well understood, lines 
uld begin to appear. As 
ns were coded until the 
Design was conducted 
- 7] 



A prototype should be inexpensive to build, at least less 
than it would cost if a conventional high level language 
were used. Indeed, prototyping in data processing originated 
only recently because until now programming a prototype was 
just as costly as programming the working system [Hef- 8]- 
The important point is to get something running soon to 
establish effective communications with the user without the 
use of extravagant resources. The follow on development of 
a prototype is a n iterative process in which improvements 
are made in small increments as the user and developer work 
together and discover new reguirements [Ref. 9]. 

Hitchell Spiegel, formerly of Hang Laboratories, 
explains the prototyping approach as: 



"...a process of modeling user reguirements in one or 
more levels of detail, including working models. 

Project resources are allocated to produce scaled down 
versions of the software described by reguirements. 

The prototype version makes the software visible for 
review by users, designers and management. This process 
continues as desired, with running versions ready for 
release after several iterations. " [Ref. 10] 



Traditional management information system development 
follows a series of steps (see Figure 2.1). Prototyping is 
considered as an adjunct activity to the specification of 
reguirements (see Figure 2.2). The results of prototyping 
are input to the steps following reguirements analysis, but 
may or may not be used actively in those steps. 

Three alternatives are possible for the disposition of a 
prototype. Having served the purpose of facilitating 
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requirements definition the prototype can he discarded. The 
lessons learned are transferred to a requirements 
specification and development of the system then follows the 
traditional system development cycle, A second alternative 
is to maintain the prototype and run it in parallel with the 
developing target system. The benefit of this choice is the 
availability of a partially functional system to the users 
until the fully capable system can be delivered. Lastly, 
the prototype can continue to be iteratively refined to 
become the target system. This alternative is usually only 
feasible in management information systems as opposed to 
embedded software, such as weapon control systems [Ref. 11]. 
Some would argue that the term prototype should only be 
applied to those instances where the system is to be thrown 
away, otherwise it is more appropriate to term the activity 
as evolutionary development [Ref. 12]. The purpose of the 
distinction is to insure that only the right decisions are 
kept and transferred to the requirements specification while 
the mistakes, especially those causing poor execution 
efficiency, are left behind with the prototype. 



There are several advantages associated with the use of 
prototyping. The primary argument for using prototypes is 
that the specifications which result are more complete 
because users can evaluate a prototype better than they can 
evaluate written specifications. In using the prototype the 
users encounter and think about problems they will have with 
the production system [Ref. 13]. Another benefit is that 
prototyping allows and encourages users to change their 
minds about what they want. Consequently, the eventual 
system is better customized and therefore more useful. This 
relates to the idea that the developmen process itself 



B. ADVANTAGES OF PRO 
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I ^ 

Feasibility Study 
Reguir ements 

Product/ Preliminary Design 
Detailed Design 
Coding 
Integration 
Implementation 
Operations and Maintenance 



Figure 2.1 Steps in Traditional System Development 



changes the users’ perceptions of what is possible, 
increasing their insights into the development process and 
affecting it. In fact, this idea is a loose corollary of 
the Heisenberg Uncertainty Principle which states that any 
system development activity inevitably changes the 
environment out of which the need for the system arose 
[Ref. 14]. Some argue that [prototyping eliminates the 
surprises at the end of the traditional development process 
because specifications, some being erroneous, haven’t been 
_frozen-and pursued without correction. Another argument is 
that prototyping shortens the development cycle, but 
experience to date has found this not always to be the case 
and that prototyping only more clearly defines what has to 
be done. ] Of importance to those suffering with technically 
oriented data processing personnel who have difficulty 
relating to people is the benefit that prototyping does not 
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Reguirements 

Product/ Preliminary Design 

Detailed Design 

Coding 

Integration 

I mplementation 



1. Identify basic needs 

2. Develop working model 

3. Demo in context S 
Solicit refinements 

4. Implement revisions 

5. Is prototype done ? 

If lES, go on to 
detailed design 

If NO, go back to 
step 3 



Figure 2.2 System DeTelopment Osing Prototyping 



require interviewing skills to the same degree as a 
traditional method of defining reguirements. Also, because 
prototyping requires spending more time with users, the 
systems analysts are forced to become more user oriented and 
aware of the user’s environment. 

The emphasis on the user is the key issue hare and 
further benefits are possible. The availability of a 
|~^rototype enables the user to evaluate the human interfaces 
I in practice and suggest changes. The user gets a more 
personalized system, regardless of the efficacy of the 
changes suggested. Thus the user is more willing to accept 
the eventual system having the perception that he truly 
affected its shape. 



I 

/ 



A working prototype enables the developer to evaluate 
the users’ performance with the human interface and to 
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_m_qdify i-^to minimize errors._j Experimentation is 
facilitated by implementing alternative interfaces without 
having to suffer the tedium of drawing specification 
graphics of one sort or another. 

It is possible to generate human-machine dialogues and 
to make minor changes quickly. 

The existence of a prototype gives the user a more 
immediate sense of the proposed system and encourges him to 
think more carefully about both the needed and the desirable 
characteristics of the system. It is easy to write 
statements in a requirements document which say ”the system 
shall do X” and ”the system shall be capable of y”. 

However, both the developer and the user get a more 
realistic feeling for the effort and cost of a feature when 
they must actually add it to a working model. Thus, the 
eventual model better represents what is feasible than a 
document with a series of "shall statements". It is 
particularly significant to note that in a typical 
development effort there is a long time between analysis and 
construction. The user only has a limited idea of what the 
system will do in such a case. Therefore, it's difficult 
for the user to be specific when dealing only with abstract 
terms. Even though the functionality of a prototype system 
is minimal the user is forced to think more carefully about 
the task being automated. This should produce a more 
accurate understanding of the problem [Bef. 15]. The 
biggest argument for prototyping is that, unlike traditional 
methods, it builds an effective bridge across the 
communications gap between the user and the analyst. 

c. /disadvantage's of pbototiping ^ 

Prototyping has some decided disadvantages as well. 

r~ 

I Prototyping makes it difficult to plan resource use because 
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a clear path of what you will be doing and when isn't 
provided. It also makes it difficult to decide whether to 
enhance an old system or build a new one. Analysts and 
users can become bored after the nth iteration of the 
prototype. In using the traditional development process 
there are specific requirements which/ when met by proof of 
validation, clearly mark the jot as complete. Because the 
prototype is changing continually, it creates a problem 
keeping users abreast of the_current version. J 

Prototyping can cause a reduction in discipline for 
proper documentation and testing,^ Because there is less 

emphasis on hard thinking and "desk checking" there is a 

■*’ — 

^greater chance of missing a basic problem which could negate 
assumptions essential to the design being devel^ped,.^' For 
large systems it is often not clear how the problem can be 
divided up so it can be prototyped a piece at a time until a 
traditional requirements study has been made. Also there is 
the chance users may become so happy with the prototype they 
consider it a functional product and want the data 
processing people to start work on something else. This can 
create a higher initial cost for the requirements phase and 
possible loss of the distinction between this phase and the 
design phase. 

A study using the ACT/1 software package for prototyping 
showed increased needs for computing resources. If the 
productivity gained from using prototyping doesn't offset 
the cost of the increased computing power, then the 
prototyping approach is serving at a disadvantage. 

[Ref. 16] 

D. APPLICATIOHS AHD GOIDANCE FOE PROTOTIPIHG 

Prototypes can be usefully applied to several different 
tasks associated with requirements analysis. These tasks 
are as follows [ Bef . 17] : 
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1. A prototype can be used to discover the optimum 
structure for the data about data (metadata) . This 
relates to the engineering use of prototypes as an 
experimental model from hhich to learn. 

2. The prototype can serve as a basis for bottom-up 
integration. 

3. They can be used to define macros that compute or 
derive new data from stored data. Abstracting in 
this manner is a process of deriving macros from a 
database. The database is enhanced having these 
macros incorporated into it. 

4. Prototypes can be used to validate domains. This is 
particularly important if there is going to be an 
active data dictionary which will assist in ensuring 
data integrity. 

5. Prototypes can be used to evaluate both update and 
retrieval efficiency. 

6. They can be used to improve the physical database 
design. 

7. They can be used to anticipate changes. This means 
to conduct experiments and step through what the user 
will do with the system to gain insight into how his 
use will foster new requirements, be they 
modifications or enhancements. 

8. They can be used to facilitate implementation and 
acceptance of a new system. 

If any of the items listed above seems sufficient to 
warrant a prototype then several conditions should exist to 
make prototyping an appropriate choice. These conditions are 
as follows: 
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1. The user’s requirements can only be defined with much 
study. 

2. The user’s needs are expected to change often. 

3. The user is willing to cooperate with the prototyper 
in answering questions. 

4. Users are willing to accept the prototype as an 
adequate and temporary solution until an optimized 
and tested system can be delivered. 

5. The area of study is well defined. Although in depth 
aspects of a problem aren’t known, the width or scope 
is confined to a particular business area. 

Prototypes aren’t appropriate for developing 
information systems strategies for an entire 
enterprise. 

6. The user has a limited set of objectives. Projects 
of large size with many different applications areas 
are not appropriate choices for use of the 
prototyping methodology. The project must first be 
functionally decomposed to identify specific business 
areas. 

7. A data dictionary is available for use. Preferably 
an automated, easy-to-use dictionary is available to 
facilitate easy recording of specifications, data 
entities, procedures and whatever else is necessary 
to model the information needs of the user [Ref. 18]. 

8. Complete honesty exists between the user and the 
prototyper. If the user isn’t satisfied, he should 
say so and be specific. Further, the prototyper 
should admit ignorance and misunderstanding. If the 
answer is no to a particular feature because it isn’t 
technically feasible, it should be so stated and 
explained, not ignored. The developer must be 
willing to interpret user difficulties as requiring 
re-examination of the application, rather than 



22 



••educating” the user, i.e. converting the user to the 
developer’s concept [Hef. 19]. 

Regarding the last point above, technical people are 
generally deeply involved with their own inventive processes 
and the reasons for their choices, and therefore are not 
inclined to consider other roads which also admit acceptable 
solutions. 

E. TOOLS FOR PEOTOTYPING 

Prototyping to define system requirements is a 
methodology. A methodology is a combination of tools and 
techniques employed within an organizational and managerial 
framework that can be consistently applied to successive 
information system development projects [Ref. 20]. A 
requirements analysis tool is any set of procedures, manual 
or automated, that guides an analyst through requirements 
specification. A manual tool is a well defined technique 
usually with a mode of graphic representation. An automated 
technique is often a specification language that combines 
keyword indicators with a natural language feature. There 
is also sometimes a specification language which, when fed 
to a processor, produces a requirement specification and a 
set of diagnostic reports concerning the consistency and 
organization of the specifications provided. [fief. 21] 

The problem with currently available manual and 
automated systems is the necessity of the user to learn some 
technical features to use the tool. An argument against 
these techniques is that the end-user should not be burdened 
with learning about the data processing field. Thus, some 
would argue it’s beneficial to have the user interact only 
with that which will become specifications for, if not part 
of, the eventual system. A categorization of tools for 
prototyping has been made and offers a means of examining 
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what is available for use. The basic requirement for any of 
these items is that they can be used for prototyping if they 
allow designers and programmers to create a working system 
in a short period of time. 

The first category of tools is data manipulation systems 
or data base management systems which can interface with a 
nonprocedural language to do data manipulation rather than 
just screen presentation. Such products as RAMIS, FOCUS 
and NOMAD are examples of this categorgy of tool [Hef. 22], 
Also in this category are relational data base management 
systems which some feel are particularly suited for 
prototyping. 

Relational data base management systems offer a high 
level of ease of use and data independence, both of which 
are advantageous for prototype development. The ease of use 
comes from the simple table data structures and the query 
languages associated with most relational systems. Data 
independence permits simple changes to logical or physical 
design without affecting existing programs [Bef. 23], 
Relational data base management systems in this instance are 
being used as applications generators. Other examples of 
applications generators are report generators, graphics 
packages, statistical packages and software for screen 
layout. These items work at a higher level than another 
category of prototyping tool, program generators. 

Program generators are software packages which, when 
given specifica tions , produce source listings, usually in a 
high order language such as COBOL, capable of being compiled 
and executed. Although not specifically oriented in the 
requirements definition area, they do provide assistance to 
requirements definition if it is necessary for the prototype 
to do actual data processing These are particularly helpful 
to programmers who must enhance the ototyj -= into a 
production system. Such program gen ^ators re not in 
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proliferation at the current time, but a sufficient cumber 
exists to make them usable in some development efforts. 

Another category of prototyping tool is libraries of 
reusable code. If a library of previously written routines, 
especially screens, exists which can be readily implemented 
to demonstrate a system's limited capabilities then the 
prototyper can easily pick and choose. This saves 
considerable effort and speeds along the process. However, 
such a library must be well organized so that the 
individual building the prototype can readily identify 
modules which suit his needs and can move these modules into 
the developing prototype with relative speed. This implies 
the code used has been well documented and generalized to be 
applicable beyond its original intent. The prototyper must 
be able to maintain momentum with users and this will not 
happen if he must stop to develop a detailed program. 

[Ref. 24] 

Hardware as well as software should be considered in 
developing prototypes. The use of a microprocessor offers 
some unigue benefits as a prototyping tool. A micro can be 
beneficial because it offers a cheaper alternative when 
considering the cost of acquiring a fourth generation 
language or a data base management system for a mainframe. 

A micro is portable and therefore can be taken to a user's 
area where currently no terminals exist. The micro can be 
left for the users to play with and discuss at their 
convenience without the possible dampening result of having 
a data processing person around. This way the end users are 
not imposed on by disruptive interviews. Finally, having to 
actually implement the features provides system builders 
better understanding of what the user wants and avoids the 
situation of just adding verbiage to a requirements 
specification. [Ref. 25] 
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F. 



DATA DRIVEN PROTOTYPING 



There exists a categorization of prototyping techniques 
which divides all efforts into 1 of 2 possibilities. The 
first category is termed applications-oriented and describes 
the situation when the focus is on transaction modeling and 
simulation technology. Most people who belong to this 
school believe prototypes should be thrown away rather than 
carried forward and evolved. The other school, the data 
driven category, believes prototypes should evolve, 
extending the architecture of the business in a process akin 
to learning. 

The thought is that requirements analysis should be an 
open system which learns from its experiences. It holds 
that freezing requirements makes for a closed system. A 
closed system is not responsive to the user and therefore 
doesn't reflect those desires which will make the system 
usable. 

The data driven prototyping technique was created around 
an abstraction approach. The analysts and users should 
abstract from an entity base rather than decomposing from a 
functional base. The data driven school of thought contends 
that functional decomposition is not realistic because its 
use erroneously assumes requirements can be precisely 
determined before system construction is attempted. The 
prototyping approach is considered valid because it operates 
on the more realistic assumption that precise requirements 
are not always definable until after construction is 
started. Some argue that the top down design techniques, 
another way of referring to functional decomposition, are 
imperative in nature; that is, they force us to concentrate 
on the operations in the solution space, with little regard 
for discerning data structures. 
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The major difference between application and data driven 
prototyping is that the latter emphasizes a dominant role 
and value for data. Data prototypers believe entities are 
the essential elements of learning and that they transcend 
individual system boundaries. The data driven school 
contends that functional decomposition is not realistic 
because its use erroneously assumes requirements can be 
precisely determined before system construction is 
attempted. 

The prototyping approach is considered valid because it 
operates on the more realistic assumption that precise 
requirements are not always definable until after 
construction is started. They assert that there is a data 
life cycle distinct from the traditional systems life cycle. 
Further, they believe the degree of integration of systems 
is a function of how much data are shared by the systems. 
From these concepts it is the job of the prototyper to 
discover and manage the integrating data in the most 
efficient and least expensive manner. The purpose of the 
data driven approach is to develop and maintain shared data 
bases (open systems) that are constantly being extended to 
accommodate new information requirements. The data bases 
should facilitate the extraction and synthesis of data into 
useful information from a static set of data structures. 

Several steps are required to apply the data driven 
approach to a particular problem. 

1. Operational reviews are conducted to evaluate the "as 
is” environment. 

2. Conceptual design is conducted to define the metadata 
structure at the center of what will evolve. 

Scenarios are built in this step to describe those 
functions for changing or retrieving the metadata. 

3. The metadata is normalized in the data design phase 
where the physical organization of the data is built. 
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4. Heuristic analysis then follows where requirement 
scenarios are exercised against the metadata 
structures using real data values. 

5. Environmental testing is conducted where programs are 
built to support data acquisition and population of 
the data bases. 

6. Quality control is applied via use of performance 
modeling to ensure the system not only reflects the 
user’s desires but is processing in a realistic 
fashion . 

Proceeding through these steps requires several tools such 
as items for information modeling, activity modeling, 
project control, a relational data base management system 
and a data dictionary. [Ref. 26] 

G. RELATION BETHEEN PROTOTYPING AND DATA DICTIONARIES 

The increasing complexity of computer systems and the 
growing demand of management that computer systems justify 
their cost and support decision-making calls for an 
integrated tool that is capable of recording and processing 
information. This information describes both the structure 
and usage of all the enterprise’s data and functions. A 
data dictionary is a tool that, if integrated with 
prototyping and the traditional methodologies, can meet the 
demands of complex systems and management [Ref. 27]. 
Prototyping has proven so successful that some computer 
service companies have been developing packages to provide 
prototyping off the shelf. Most of these packages assume 
the existence of a fully descriptive data dictionary or else 
require the establishment of one [Ref. 28]. Some feel that 
the eventuality of extensive networking and distributed 
processing coupled with failure to properly elicit needs 
makes it imperative that data dictionaries be integrated 
into requirements analysis efforts [Ref. 29]- 
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Figure 2.3 Integrating Function of A Data Dictionary 



The data dictionary that results from requirements 
analysis can be a two-edged sword. It can become both a 
source and receptacle for the prototyping effort. Without a 
data dictionary of some type, preferably one that can be 
used as cin adjunct to a software library, the analysis task 
is impossible. The dictionary can be used as a source of 
information necessary for prototyping since it can define 
entities, attributes and relationships at a conceptual 
level. A data dictionary can contain the output of 
prototyping in an organized, easy to manipulate database 
instead of using an unwieldy written document [Ref. 30]. In 
essence, a data dictionary should be at the center of the 
effort and serve to integrate all the conceptual output 
produced by the tools being used. 
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III. DATA dictionaries 

A. DATA CENTEBED SYSTEM ANALYSIS 

An understanding of the role data dictionaries play in 
software prototyping first requires an understanding of the 
underlying philosophy regarding their use. This philosophy 
is a data centered view of system analysis as opposed to a 
process centered approach. 

Data centered system analysis treats the data as a 
separate resource. Processes are still considered 
important, but the target of all processing activity is 
data. An aspect of this approach is a perception of data 
processing as a succession of changes to data. A process is 
viewed as a series of data changes. The data centered 
approach contends that, in the long run, designing a stable, 
well-uocumented and largely non-redundant structure of data 
provides a simpler and cleaner form of data processing than 
enibfedding separately designed data structures into many 
different processes or applications programs. 

Several advantages accrue from the data centered 
approach. The data centered approach helps avoid problems 
with file proliferation, mai nte ranee , data redundacy and 
data inconsistency. Once the appropriate data bases are in 
place, some types of applications can be created quickly 
with high level data base languages. Individual users 
having direct access to the data bases can often create 
their own reports and applications, thus avoiding the slow 
steps of formal system analysis. Assembling data in 
different ways from the current inventory is not possible 
without a data dictionary. Data administrators, programmers 
and users cannot realistically be expected to have 
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sufficient knowledge of the logical organization of data 
bases to readily pick and choose data as needed to derive 
applications. 

There are distinct disadvantages to the data centered 
approach. The data bases used must be well designed, yet 
the technology of good data base design is often not 
understood. The data centered approach implies the sharing 
of data which requires different management from that 
applied to a collection of separate files. There are 
conversion problems in moving from the traditional process 
centered to the data centered approach. Some of these are 
human behavioral problems caused by users losing control of 
data they previously ••owned". The cost of conversion to a 
data base environment can be enormously expensive. The data 
centered approach is often more difficult to manage in its 
early phases, because of pressures to adopt quick alternate 
solutions or to maintain the status quo. Once set up, 
however, the data centered approach is easier to manage than 
a process centered one. Management must understand these 
issues clearly for the approach to work. 

A key to controlling data bases and facilitating quick 
development is a data dictionary, A data dictionary can 
function as a tool, but tools should not get in the way of 
the primary goal: solving the problem. Any tool used for 
requirements analysis must contribute to managing project 
complexity rather impeding progress. Capturing the data 
which desribes the data held in the database, the metadata, 
must be a smooth, easy process which does not burden the 
momentum of discovery built in working with users. Users 
know what they do and therefore can describe processes far 
easier than data. Metadata is the essence of the means of 
achieving high productivity, shared databases and reduction 
of the inefficiencies associated with the traditional 
development process. [Ref. 31] 
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B. HEIADATA 

Metadata is the term applied to that data which 
describes other data or databases. Metadata include 
descriptions of the meaning of data items, the ways in which 
the data are used; the sources cf particular data elements; 
the physical characteristics ; and rules or restrictions on 
their forms or uses. Some choose to classify metadata 
elements into 3 types: semantic, physical characteristic, 

or usage information. [Ref. 32] 

Semantic information is comprised of the names of the 
component or entities. A unigue identifier should be 
assigned to each component even though it may be known by 
other names. These other names are called aliases. The 
documenting and tracking of aliases promotes data sharing 
across applications. The prevalence of aliases should not 
be encouraged or discouraged, but should be accepted as a 
fact of life. End-users call things by different names and 
a data dictionary, as an adjunct to the database which 
models the real world, should accommodate that fact. 

Physical characteristics are those items or information 
which describe the system dependent representation of the 
component. The length in bytes of a data element, or the 
access method for a particular file are examples of physical 
characteristics. This category includes relationships among 
systems and programs which use the database. That a 
particular data element may be found in records x, y and z 
and is referred to by programs A and B is an example of 
physical characteristic metadata. 

Usage information illuminates how and by whom data are 
used. This type of information enables the database 
administrator to trace the source of errors. The existence 
of usage information also permits the database administrator 
to assess the impact of changes on the database and helps to 
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develop structures to monitor and control access. If the 
scope of a data dictionary is widened to incluie usage 
information then it must include data about users and 
processes as well as data about data elements. Processes 
can be performed by individuals, organizations, programs or 
entire systems. A process can be a single transaction, the 
generation of a particular item such as a report, or a broad 
function such as production of the entire monthly payroll to 
include checks, vouchers and a summary report for 
management. In compiling usage information, responsibility 
for a database related task should be assigned to a 
particular process to enable monitoring and correction. The 
source of a transaction, such as entering the number of 
hours worked for a payroll application, should be documented 
and traceable. In this example, a clerk may be used to 
verify and enter the number of hours worked. [Bef. 33] 

Metadata can also be classified as one of three types of 
entities. Entities are either "real world” objects or 
concepts such as customers, accounts, salespersons and 
orders. Metaentities can be classified as metadata 
entities, metasystem entities and meta-environment entities. 
[Ref. 34] 

Entities which represent data objects, such as data 
elements, groups, records, files, databases or reports are 
examples of metadata entities. An element is a simple 
single item and is a "primitive", that is, it cannot be 
further divided. Elements can he accumulated, usually 
logically, to form other higher level metadata entities such 
as groups or records. A savings account number is an 
example of a data element. A data element can be recursive, 
meaning it can be formed or conceived as consisting of other 
data elements, yet for purposes of the particular 
application cannot be further subdivided. A savings account 
number may be separated by hyphens when printed and the 
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separated parts can represent different meanings, such as 
branch, type account, and specific customer. However, these 
different numbers will always be carried together as a 
singular item. [Ref. 35] 

Two or more data elements can be collected into what is 
called a group. Groups can contain other groups. The 
elements or groups collected to form a group are usually 
logically related in some fashion. Thus, in the example of 
an address group the elements street, city, state and zip 
code are the logically related elements comprising the 
group. Groups are aggregations larger than an element but 
smaller than a record. 

A record is a collection of one or more related data 
elements or groups that is treated as a logical unit. Each 
employee of a company, for example, would have one record 
and it would be a collection of these data elements and 
groups; name, department, employee number, age and hone 
address. [Bef. 36] 

A file is a set of occurrences of records treated as a 
unit. Different types of records may be contained within a 
single filt, or it can contain many occurrences of a single 
type. An occurrence is where actual values nave neen 
assigned to the fields or data elements of a record, and the 
record therefore now models the reality of the entity on 
which it is based. [Ref. 37] 

A database is an aggregation of DBMS files, records, 
groups and elements. Databases vary in both logical and 
physical organization depending on the data model used to 
design the database and the DBMS used to implement the 
database. [Bef. 38] 

Reports are also classified as metadata entities 
although, unlike any of the previously discussed entities, 
reports are usually not stored but produced on execution of 
a subsystem or program. A report is a formatted 
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representation of information, not data. Data is 
manipulated and given meaning when a report is produced. 
Data items are facts which, without manipulation and 
association with other facts, have no meaning to humans. 



Database 




File 




Record 




Grou p 




Data element 





Figure 3.1 Hierarchy of Metadata Entities 

Systems, programs, subroutines, and modules are all 
examples of metasystem entities. This class of 
metaentities represents processes of the data processing 
environment. [Ref. 39] 

A system is a collection of related programs or systems 
which together perform a set of functions for some general 
purpose. For example, a payroll system might consist of 
many programs: one for producing checks, one for updating 

an employee database, and one for producing a summary 
report. 

A program is a collection of source code statements (in 
assembly, compiler, guery or fourth generation language) 
that accomplishes one or more actions. Programs contain one 
or more modules. 
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A module is a collection of executable statements which 
exists to accomplish one specific application function. 
Modules are the result of software being divided into 
separately addressable collections of source language 
statements. Modules can be categorized in one of three ways 
[Ref. 40] : 

1. Sequential types which are referenced and executed 
without interruption of the application software. 

2. Incremental types which can be interrupted before 
completion and restarted at the point of 
interruption. 

3. Parallel types which execute simultaneously with 
another module in a multiprocessor environment. 

A transaction is any event that requires the database 
information to be accessed. Transactions are char acterized 
by type (batch or on-line), frequency (i.e. number of times 
per month) , and use (add, delete, modify) . Transactions are 
usually thought of as manual actions taken by a user which 
result in actions being taken by the software system. 

Interfaces are places at which independent modules, 
programs, or systems meet and either act on or communicate 
with each other. Interfaces can be hardware, software, human 
or procedural components of a system. Host often there is a 
transfer of data across an interface which must be clearly 
understood. An interface description should provide a list 
of all data that enters and exits a component. For a single 
module the description should indicate what data moves 
across an argument list, any external world input/output 
information that is used and information acquired from 
global data items. An example cf an interface description 
for a module which calculates the miles per gallon being 
used by a digital automobile dashboard system would look as 
follows [Ref. 41 ] ; 

Calling protocol: CALL CALC-HPG (MPH,GPri, MPG) 

w here 
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MPH is miles per gallon (real, input) 

GPH is gallons per hour (real, input) 

MPG is miles per gallon (real, output) 

No external I/O or global data are used 
CALLED BY: DATA-CONV-CTL 

CALLS: no subordinates 

The environment constitutes another category of 
meta-entities. This category can be divided into many 
different items if it is desired that the system track the 
equipment configuration as well as the data. If not, then 
the category of physical devices is sufficiently descriptive 
and refers to such items as a CRT terminal, printer, disk 
drive, etc. [Ref. 42] 

An important aspect of gathering and analyzing metadata 
is describing it. Descriptive adjectives, categories and 
properties of an entity are called attributes. Plagman and 
Leong-Heong cite eight generic categories of meta-entity 
attributes: 

1. Identification attributes which designate, describe 
or somehow identify the entity. Entities may be 
known by more than one name depending on the time, 
place and user's frame of reference. 

2. Relationship attributes denote associations between 
two meta-entities. For example, one entity may be 
used by another. Relationship attributes are 
sometimes similar to interfaces. A link, subroutine 
call, access path or mapping qualify as a 
relationship type attribute. 

3. Representation attributes describe an entity as it is 
implemented. A data element is represented in terms 
of character (alphabetic, numeric or mixed) , source, 
or length. 
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Statistical attributes are numerical descriptions 
such as frequency, estimated life, and usage. This 
class of attributes are useful to the Database 
Administrator in assessing the impact of changes and 
for optimizing queries. 

5. Physical attributes help describe environmental and 
system entities. Examples are storage media, storage 
size, terminals and CPU model. 

6. User-defined attributes are those things about a 
particular application such as the users, analysts, 
designers, customers, etc. that are helpful. A 
•'free-f orm'* attribute is included in this category. 
This is often implemented as a comment field but can 
be specifically named if the user desires. 

7. Control attributes are descriptors for how restraint 
over an entity is exercised such as security 
classif ication or edit criteria. 

8. Status attributes provide the life cycle status of 
the entity; e-g. candidate, test, operational, 
deleted or archived [Ref. 43]. 

a) A test status means the entity can be modified 
with approve of soraecne in project management. A 
test entity is not for production runs or general 
use. 

b) An item categorized as operational is being used 
by the system on a regular basis. Modification of 
the item, especially in a file oriented (as 
opposed to a DBMS oriented) environment, may cause 
problems and therefore is carefully controlled. 

c) Archived means the item is no longer used 
operationally anywhere in the automated components 
of the system. "Old timers" may still refer to 
archived entities and, therefore, such items 
should be available for reference, but not for 
use. 
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TABLE I 

The Grouping of Beta- Entities 





SYSTEM/PROCESSING 


ENVIR,OH MENTAL 


Element 


System 


Physical Devices 


Record 


Subsystem 


Computer system 


Group 


Program 


Terminal 


File 


Module 


Line 


Database 


Transaction 


Users 


Screen 




Node 


Report 




Function 



Indicating the status of a meta-entity is important for 
the purposes of project and configuration management. It is 
important to know whether a simple data element, a program 
or an entire system is either under development, being 
integrated or operational. 

It is obvious from this discussion that the task of 
managing metadata can be as challenging as managing the 
user’s data. Consequently, the same techniques can be used 
to manage metadata, that is, organizing it into a database, 
the data dictionary. 
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C. DEFIHITIOH AHD OBJECTIVES Of A DATA DICTIONARY 

Familiarity with what constitutes a data dictionary and 
the purpose for having one are requisite for later 
understanding of its role in requirements analysis. The 
need for documenting data is obvious and grows from the 
universally recognized need to document the two primary 
components of any software system, functions and data. A 
data dictionary is a repository of data about data and 
processes associated with a particular systems development 
effort. A dictionary often includes a glossary of terms, 
data characteristics, process descriptions, and some 
cross-referencing mechanism. 

Data dictionaries come in three different forms. 

1. The data documentation for a system can be made a 
part of either the requirements specification or a 
design document. 

2. A data dictionary can exist as a separate printed 
document. 

3. A data dictionary can be an automated data base. 

Data dictionaries can be expanded to include information 
about the physical location of the data. In that case it 
becomes a data dictionary/directory. If either the data 
dictionary or data dictionary/directory uses software to 
store and access the data, it is considered a system. The 
following delineates feasible manifestations of a 
diet ionary : 

1. A data dictionary is a repository for data about data 
and functions. 

2. A data dictionary system is a software system to 
store and access data about data and functions. 

3. A data dicticnary/direc tory is a repository about 
bo*-h logical and physical information for data and 
f u..-tions . 
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A data dictionary/directory system is a software 
system to store and access both logical and physical 
information about data and functions. 

Several criteria are worth examining in deciding which 
way to document data. These are: 

1. Estimated size and complexity of the system. 

2. Extent of sharing of data between systems. 

3. Use of a generalized DBMS. 

4. Availability of automated data dictionary software. 

5. Number of data descriptions. 

6. Complexity of data structures. 

7. Volatility of data descriptions. 

8. Number of analysts and programmers involved. 

9. Number of organizations involved. 

10. Amount of clerical assistance available. 

11. Uses of the data documentation. 

The greater the number and strength of these factors, the 
earlier a decision must be made about which means to docu- 
ment data, and the stronger the probability that that means 
will be an automated system. Regardless of form a data 
dictionary should document several different components. 

All files, record types, items within records and 
pertinent information about the use of the data should be 
included in the data dictionary. Pertinent information 
includes such items as physical description, logical 
description, and functional description of how the data is 
used. Further, it elaborates on how the data is changed, 
how it is removed, and how integrity is ensured. 

Based on the information the dictionary holds, it may 
satisfy many objectives [Sef. 44]. Generally any data 
dictionary should provide facilities and formats for 
documenting the information collected during all stages; 
analysis, design and implementation. Further, it should 



help the analysts follow any of the structured methodologies 
available for system development. Data descriptions, not 
only processes, should be traceable back through program 
functions to the original statement of requirements. The 
dictionary should be readily extensible to accommodate 
growth or expanded application. Its existence should help 
achieve the establishment of a glossary of terms and thus 
provide for standard terminology. Analysis can be 
accomplished using the proper terms in the proper context 
in dealing with the user's particular application area. 
Semantics are important for both understanding the user's 
area and for tailoring the system to his frame of reference. 
Modules which are available to all systems should be 
identified via a generic cross-reference capability. 

Going beyond the analysis phase, the dictionary can 
provide assistance in generating manageable and complete 
test data. Problems which arise associated with aliases and 
acronyms can be resolved via a data dictionary. As an 
adjunct to configuration management, a dictionary provides 
centralized control for system changes. Again going beyond 
the analysis phase, a dictionary can serve as a reference 
and guide in training users and for design evolution. 
Maintenance efforts can be assisted in a similar vein in 
that programmers unfamiliar with specifics can refer to the 
dictionary as a guide. 

Having met a majority of these objectives, a dictionary 
should be capable of answering several questions [Bef. 45], 
[Ref. 46]. 

1. What kind of validity tests have been applied to this 
data type? 

2. Who is authorized to update this data item? 

3. What modules, programs or systems use this data type? 

4. What are the valid ranges of values for this data? 
(domain] 
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5. What security level is applied to this item? 

6. Who is allowed access to the data? 

7. By what other names is the data type known in various 
application environments? (the differenses should be 
minimized) 

8. In what reports does this data type appear? 

9. What is the input source for this data type? 

10. What are all the data items used by a given program 
or report? 

Data dictionaries may have problems, particularly if 
they are not well organized. If a dictionary is fully used, 
meaning that if it is an active dictionary which serves a 
controlling function, then it becomes a centralized 
controlling facility. Centralized control of data is not 
always desirarable or appropriate. For a data dictionary to 
get to this point, considerable effort must be expended. 
Therein lies another problem in that development and 
implementation, to be useful, requires careful thought and 
considerable effort £Eef. 47]. Another problem is the lack 
of a methodology which ties the use of a dictionary into the 
overall system development effort. Dictionaries need to be 
able to support and measure the documentation progress. 
Unfortunately the means of describing primitive entities in 
different commercial data dictionary packages is dissimilar. 
Few dictionaries have specific provisions for supporting a 
structured analysis technique [ Eef . 48]. Features which are 
important for database design, but absent from many current 
products are support for distinguishing between a data 
element and its domain and the lack of a graphic 
representation capability. In response to these problems 
this thesis proposes that a model that is easily understood, 
the relational, be used to organize a data dictionary. 
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The relational model is appropriate for protoyping with 
data dictionaries for several reasons. As discussed 
earlier, the ease of use, availability of query language and 
data independence make relational-based DBMS good tools for 
prototyping. The relational model is good for data 
dictionary implementation because many relational DBMS have 
a "triggering” mechanism causing a program to be invoked on 
some data event or condition. This is an essential feature 
for a data dictionary to be active, that is, to serve as a 
monitor of database activity to ensure data integrity. An 
additional advantage is the schemas of relational systems 
are tables. This can reduce the work required to implement 
the dictionary system. For these reasons, and because 
relational DBMS are now available for microcomputers, a 
prototype data dictionary has been developed and is 
described in the next chapter. 
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IV. A BATA DICTI OHAH Y BASED ON THE H ELATION A L MODEi 
A. IBTfiODOCTIOF 

The office of the Deputy Chief of Staff for Plans 
(DCSPLANS) f the OS Army Military Personnel Center 
(MILPERCEN ) , has the responsibility to develop and maintain 
computer based modelling capabilities to support personnel 
policy development for the Army. DCSPLANS has subordinate 
branches each of which uses and/or maintains models. In a 
prototype effort to assist DCSPLANS organize and account for 
these information resources, a relational dictionary system 
was developed using the dBase II relational DBMS. 

The prototype system is capable of running on an IBM 
Personal Computer. A relational based DBMS was used because 
of the features previously discussed. A microcomputer- based 
version was used to facilitate transfer of the prototype 
from the development site at the Naval Postgraduate School 
to MILPERCEN at Alexandria, VA. 

The dictionary accounts for several different relations 
including reports, offices, models, programs, files, 
elements (which are partitions of files, rather than data 
elements) and fields. The generalized format of these 
relations is as follows; 

REPORT ( rname, full_name, number, status, sec_class, 
output_for mat, purpose, description, perdiodicity) 

OFFICE ( gfc, oname, bldg, room, phone, comments, poc) 

MODEL ( mdl . model_name, methodology, status, location, 
purpose, description, runame, perdiodicity) 
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PROGRAM ( pname . vers ion , location, language, purpose, 
description, status, perdiodicity) 

FILE ( f name , full_name, last_update, media, status, 
sec_class, purpose, description, poc) 

ELEMENT ( e ln ame, version, date, seg_num, size, poc, purpose, 
location) 

FIELD ( fid , length, data_type, cull_status, source, domain, 
description, purpose, status, sec_class, poc) 

For a detailed explanation of the attributes for these 
relations, see Appendix B, ata Dictionary Data Elements. 

Relationships amongst the various relations are tracked 
by having relations with a verb name reflecting how one 
entity relates to another. For example, since a MODEL may 
be used by many different OFFICES, a USES relation is 
included in the dictionary. Its format is as follows: 

OSES ( ofc, ename, etype) . An example occurrence of this 
relation would be: 

OSES (DAPC-PLF, P3M, MODEL) 

which states that the office DAPC-PLF uses the P3M model. 

There are six of these verb type relations. In addition to 
the OSES relation these are CONTAINS, MAINTAINS, OUTPUTS, 
INPUTS, and CALLS. The generalized format of each of these 
is as follows: 

CONTAINS { enamel , et ype l , ename, etype) 

MAINTAINS ( ofc, mdl, model_poc) 

OUTPUTS { e name l , e tv pel . ename, etype) 

INPUTS ( enamel , etyp^, ename, etype) 

CALLS ( enamel , e typ el, ename, etype) 
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The attribute ename stands for entity name and the attribute 
entity type stands for entity type. In general, these 
attributes can be instantiated by any entity (e. g. model, 
program, file, element, etc.) The specific relationships 
these relations track {see figure 4.1) are as follows: 

1. An OFFICE uses many different REPORTS. 

2. An OFFICE uses or maintains many MODELS. 

3. A MODEL is used or maintained by many different 
OFFICES. 

4. A MODEL calls many different PROGRAMS. 

5. A MODEL outputs many different FILES. 

6. A MODEL inputs many different FILES, i. e. requires 
many different FILES as inputs. 

7. A MODEL outputs many different REPORTS. 

8. A FILE contains many different ELEMENTS. 

9. An ELEMENT contains many different FIELDS. 

10. A FIELD is contained by many different ELEMENTS. 

There are two special relations which are neither pure 

entities nor verb descriptors. These are ALIAS and 
CATEGORY. 

The ALIAS relation provides a means of tracking entities 
by all known names. Often an entity is given one or more 
names other than that by which it*s officially known. For 
the users the other name, the alias, is the natural way of 
referring to the entity and therefore the dictionary should 
accomodate that. The Personnel Policy Projection Model 
being called '•Pimmy" is an example of an alias. 

The CATEGORY relation provides the basis for Key Word In 
Context (KWIC) capability. Further, it allows the user to 
categorize different types of entities and relate them in an 
ad-hoc fashion. For example, if several files and programs 
were the responsibility of a particular programmer to audit, 
all those different entities could be entered as category 
records with that programmer's name as the particular 
category. 
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The format of the ALIAS and CATEGOfiY relations is as 



follows: 

ALIAS ( ename , etype, aname) 
CATEGORY ( ename, et y pe , cat) 



REPORT 



T 

V 



PROGRAM 



« »j OFFICE 

MODEL I « 

I 

T 

V 

FILE 

I 

7 

ELEMENT 

V 

V 

FIELD 



Figure 4. 1 Bachaan Diagram of Entities 

Structuring the metadata as shown above offers 
advantages for ease of learning and using the data 
dictionary. The logical structure is based on a 
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conmercially successful data dictionary system, DataManager. 
The data dictionary is a database and therefore models the 
real world in a limited fashion- By taking a da ta-centered 
viewpoint wherein all entities are categorized as either 
objects (i. e. models or reports), or processes (i.e. uses, 
contains, maintains) which act on objects, an 
easy-to-understand model emerges. Conseguently, use of the 
dictionary is facilitated so that it becomes a tool, rather 
than a burden to the data system developer /maintainer/user. 
This will be substantiated by the following discussion of 
the system structure and guery/report capabilities. 

B. SYSTEH STROCTORE ABD OSER IHTBRPACE 

The software of the system was structured to provide all 
the possible functions one might wish in a database system. 
These are the ability to add, change, or delete records and 
to provide reports and queries (see Figure 4.2) . Because 
the system is a prototype and specific user needs are 
unknown, all functions are provided. Depending on user 
feedback and observations made by the analyst, these 
functions can be expanded to offer different dialogues or be 
converted to batch procedures. 

The user interface for any interactive system is an 
important criterion for success. Because a data dictionary 
system should be a tool to facilitate software system 
development and maintenance, it should provide a friendly 
user interface. This data dictionary system is menu and 
prompt driven. The software prompts for all necessary data 
and actions to develop and maintain intersection records 
(in this system called processes or verbal relations such as 
CONTAINS or USES). Consequently the user manual for the 
system is not a long and trying document to use. 
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MAIN MEND 

1 






aId 

MENU 


chInge 

MENU 


deIets 

MENU 


1 

quIry 

MENU 


reIort 

MENU 


add-model 
add-office 
add-report 
add- program 
add- file 
add- element 
add-field 
add-alias 
add-category 


chg- model 
chg-off ice 
chg- report 
chg- program 
chg-file 
chg- element 
chg- field 
chg-alias 
chg-category 


del-model 

del-office 

del- re port 

del-program 

del-file 

del-element 

del-field 

del-alias 

del-category 


fortrev 

baktrev 

foral 

bakal 

forcat 

bakcat 


SUQOd 

sumrep 
sumfil 
sumof f 
sumrep 



Figure 4.2 Hierarchical Chart of Software 



The query interface is particularly friendly. The 
system, named dDICT II, provides two types of queries, 
forward and backward. Forward means the user is presented 
columns of relations from which to pick. The columns, 
following the forward flow of the English language, are 
subject, verb and objects. The user provides the unique 
name of an entity beside its type in the subject column; 
marks 1 appropriate verb column and 1 appropriate object 
column. For example, to answer the question "What models 
does the office with symbol DAPC-PLF use ?" the Figure 4.3 
depicts how the screen of the FCSTEEV program would appear. 
The Figure 4.4 depicts how output from this query would 
appear. Verb and object choices must be appropriate for the 
subject in that it is not possible to get any response from 
a query marked for which there is no relationship defined. 
For example, marking the screen of the FORTREV program to 
answer the question "What models contain what fields ? " 
would elicit no response when processed. 
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— 

SUBJECTS 


VERBS 


■ 

OBJECTS 


Office:DAPC-PLF 


; Uses;X; 

Maintains; ; 


Reports; ; 
Models; X; 


Model; 


; Calls; ; 

Inputs; ; 
Outputs; ; 


Programs; ; 
Piles; ; 


File; 

Element; 


• 

Contains; ; 

• 

m 


Elements; : 
Fields; : 


To quit put an 


X in this field ; 


• 


Put the unique name of the entity you are querying about 
in the field next to the entity's type. Then place an X 
in one appropriate verb field for that entity type and 
an X in 1 appropriate object field- 
I-E- Of fice;6APC-PLF ; Uses;X; ModelsrX; 

To process query move cursor through remaining 
fields using RETOEN key. 



Figure 4.3 Example of a Forward fietrieval 



I 1 

The office DAPC-PLF uses the following models 

P3I1 

OAS 

Strike any key to continue. . . 

WAITING 



Figure 4.4 Sample Output From a Forward Retrieval 

The backwards approach is implemented by presenting 
from left to right columns of objects, verbs and then 
subjects- Thus, to answer a question such as "What offices 
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use the P3M model ?” see Figure 4.5 for how the the screen 
of the BAKTEEV program would be marked. This query will 
produce the unique names of the offices that use the P3M 
Model and Figure 4.6 shows how the output would appear. 



OBJECTS 



VERBS 



SUBJECTS 



Model: P3M 
Report: 



Is used by:X: 
Is maintained by: : 



Program: 

File: 



: Is called by: 

Is inputted by: 
Is outputted by: 



Element: 

Field: : 

To quit put an 



Is contained in: : 
X in this field: : 



Office: X: 



Model: : 



File: : 

Element: : 



Enter the name of the entity besides its type and then 
mark 1 verb field and 1 subject field. To process 
query move cursor down through remaining fields 
using RETURN key. 



Figure 4.5 Example of a Backward Retrieval 

Because the ALIAS and CATEGORY relations are each a 
special case, they are given their own respective forward 
(FORAL & FORCAT) and backward (EAKAL & BAKCAT) query 
programs. For example, if you wish to know all the aliases 
that exist for all models in dDICT II you would execute the 
FORAL program and mark the menu as in Figure 4.7 and Figure 
4.8 shows how the output would appear. 

If you wish to know all aliases for an entity for which 
you knew the name you would use the BAKAL query. For 
example, if you wanted to know all the aliases for the ?3M 
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The model P3H is used by the following offices 



DAPC-PLP 

DAPC-PLT 

DAPC-PLS 

DAPC-PLF 



Strike any key to continue . .. 
WAITING 



Figure 4.6 Output From a Backwards Retrieval 



Hodel:X: 
Program: : 
Report: : 



File: 

Element: 

Field: 



Enter an X in the field beside the type of entity 
for which you want all names and aliases. Mark only 1 
field. 



Figure 4.7 Example of FORAL Menu 

model you would mark the menu of the BAKAL query as in 
Figure 4.9 and Figure 4.10 shows how the output from that 
query would appear. 

The FORCAT program permits you to determine all 
occurrences of a type of entity and in what category each 
occurence falls. For example, if you wish to know what 
models had been categorized in some way see Figure 4.11 for 
how to mark the menu of the FORCAT program. Figure 4.12 
depicts how the output would appear. See Figures 4. 13 
and 4.14 regarding use of the BAKCAT program. 
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The following models have the associated aliases 

P3H PIHMY 

P3M PAIN 

OAS ASSETEE 

Strike any key to continue . .. 

WAITING 



Figure 4.8 Example of Output From FOSAL Query 



Model;P3M 

Program; 

Eeport: 



File: 

Element; 

Field: 



Enter the name of the entity in the field 
beside its type. Provide only 1 name. 



Figure 4.9 Example of BAKAL Program 







1 


The model P3M 


has the following aliases 




PIMMY 

PAIN 






Strike any key 
WAITING 


to continue . .. 





Figure 4.10 Example of Output from BAKAL 
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Model: X; File: : 

Program: : Element: : 

Report: : Field: : 

Enter an X in the field besides the type of 
entity for which you want all names and associated 
category. Marx only 1 field. 



Figure 4.11 Example of Menu for FORCAT Program 



I 1 

The following models are in the associated category 

OAS OFFICER 

Strike anv key to continue . .. 

WAITING ' 



Figure 4.12 Example of Output From FORCAT 

For more extensive information about a particular Model, 
File, Office, or Report, the Report subsystem exists. This 
subsystem has a menu from which the user selects the type of 
report program to execute. The system will then prompt the 
user for the unique name of an entity. From that the system 
will then provide a printed summary report which provides 
all entities which have a direct relationship with the 
entity named. Thus, if the user provides the unique name of 
a Model, the printed report would list: 

1. All offices which use the Model. 
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ModelrOAS : File: : 

Program: : Element: : 

Report: : Field: : 

Enter the name of the entity in the field beside its 
type. Provide only 1 name. 





Figure 4.13 Example of Henu for BAKCAT Prograa 



j ^ 

The model OAS is in the associated category 
OFFICER 

Strike any key to continue 
WAITING 



Figure 4. 14 Example of Output for BAKCAT Program 

2. All offices which maintain the Model. 

3. All programs the Model calls. 

4. All reports the Model outputs. 

5. All files the Model either inputs from or outputs to. 

For example, if you wished to have a summary report for the 

P3M model you would select option 1 from the Reports menu 

for execution of the SUMOD program. The system would then 

prompt you as follows: 

Please enter the unigue name of the Model 
Hit the space bar and RETURN to guit:P3M 

Figure 4.15 shows how the output would appear. 
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1 



The Model P3 M 

Is used by the following offices: 



DAPC-PLP 

DAPC-PLT 

DAPC-PLS 

DAPC-PLF 



Is maintained by the following offices with 
the point of contact: 



DAPC-PXF KALINICH 

Inputs the following files: 

P3MDATA 

Outputs to the following files: 
P3M00TPUT1 

Outputs the following reports: 

EPHE 

P3MSEP1 

Calls the following programs 

P3MPE0GUN01 

P3MPR0GD0S1 

P3MPBCGTBES1 



Strike any key to continue 
WAITING 



Figure 4. 15 Example of Report Output 

Providing these guery and report capabilites makes the 
dictionary more than a repositoiry but a fully capable tool. 
Use of the dictionary to manage data is not merely made 
possible but truly facilitated. The data administrator can 
quickly input or retrieve metadata as appropriate to impose 
order, control and effective management of a critical part 
of the organization's resources. Implementation and use of 
a dictionary marks an important step in an organization 
towards knowing what data assets it has and most 
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importantly, what data assets it needs. Needs are 
requirements the specification of which must be precise to 
be i mplementable. For example, knowing exactly what fields 
occur in what elements and, therefore, what else we need to 
accomplish some function is a critical question to be 
answered in defining requirements. Having an automated and 
interactive means of answering such questions provides a 
decided advantage over using textual documents. This 
dictionary thus provides an important tool from which the 
data administrator can more expeditiously manage the 
organization’s current data processing capabilities. 

Because the user of this dictionary is located across 
the country from the development site, a demonstration 
version of the dictionary was created and populated with 
example data (see Figures 4.16 and 4.17). The demonstration 
version can be used to learn the capabilities of the system 
without fear of destroying anything. Once confident with the 
operation of the demonstration version, the user can migrate 
to the production version. 

Because dDICT II is a prototype it is missing features a 
refined and full production system would have. Host 
importantly, the software doesn’t enforce relational 
constraints. Thus, seme entities can be present without 
others also being present. For example, a program can exist 
without there also existing a model which calls that 
program. It remains to be determined how important it is 
for metadata integrity to have the software enforce 
relational constraints. Further, dDICT II does not enforce 
what can be entered for a particular attribute of an entity. 
Because many of the attributes contain narrative text it is 
not possible to develop precise logic for what can and 
cannot be entered. However, this is a refinement which 
should be a ’ded ice the user has migrated to the production 
version and populated it with real metadata. The attributes 
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Model; OAS 



Reports; OPME, OASEEPI 
Users; DAPC-OPD, DAPC-PLF 
Maintainers: DAPC-OPD 
Programs; 0ASPBGUN01 , OASPEGDOS1 



Input file; 


OPDOASDATA 




Output file 


; OASOOT 


Element; 


INSPEC 




Element; 


ADSPEC 


Fields; 


grade 




Fields; 


name 




in spec ode 






grade 




commsv r 






adspecode 




degrees 






yrssvc 




dor 














Element; 


OPMEECAP 


Element; 


DRATE85 








Fields; 


oct 




Fields; 


oct 




nov 






nov 




dec 






dec 




Ian 






jan 




f eb 






feb 




mar 






mar 




apr 






apr 




may 






may 




jun 






iun 




gul 






gul 




aug 






aug 




sep 






sep 


Aliases; 


OAS ASSETEE 








DRATE85 


UTEI 






Categories; 


DRATE85 


numeric 








OAS 


officer 








0ASPEGUN01 


cobol 








0ASPRGD0S1 


development! 





Figure 4. 16 First Example of Demonstration Data 

used in describing metadata entities lack precision and need 
tightening in follow-on efforts. Precise domains need be 
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— 




• 


Model: P3M 






Reports: EPMR, P3HREP1 






Users: DAPC-PLP, DAPC-PLT, DAPC-PLS 




Maintainers: DAPC-PLF 






Programs: P3MPR0GDNO1, 


P3MPRCGD0S1, 


P3MPROGTRES1 


Input file: P3MDATA 


Output file: P3MOUTPOT1 


Element: SEEPAGE84 




Element: TNGPROG84 


Fields: mosto 
mosf 

el through e8 


Fields: si 

codes 

npstng 

pstng 


Element: VALIDHOS 




Element: CRSLENATR84 


Fields: cmf 

ets yr 

etsmd 

tdat yr 

t datmn 

bgrade 

egrade 

title 




Fields: wks 
att 


Element: AUTHCOR 
Fields: e3 through 


e9 




Aliases: P3M 

P3M 
EPMR 

P3MPR0GUN01 

P3MPROGDOS1 


PIMMY 
FAIN 
3PPER 
PIMMY1 
PIMMY 2 




Categories: P3MPEOG0NO1 
P3MPB0GD0S1 


cobol 

fortran 





Figure 4.17 Second Example of Demonstration Data 



determined, documented and enforced by edit criteria. 
Refining tbe user's specification of metadata will 
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facilitate more extensive guery and report capabilities. It 
is only possible with more specific domains that a more user 
friendly guery interface can be developed, possibly using 
artificial intelligence technigues. Osing artificial 
intelligence technigues will lead to a more useful tool 
capable of assessing the impact of change on the databases 
through sensitivity analysis on the dictionary. 
Unfortunately, the prototype version is not '•instrumented" 
to capture user peculiarities for enhancing friendliness 
and performance. Because dBASE II was used, the system 
suffers poor performance in comparison to what would be 
enjoyed using dBASE III. A full production version would be 
inordinately slow if not implemented in dBASE III. 
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V. COHC LOS IONS 



This thesis has investigated the use of prototypes and 
data dictionaries as vehicles for assisting requirements 
analysis. It has explained the advantages and disadvantages 
of prototypes; provided guidance for their use; explained 
tools that are needed and provided a data driven approach to 
prototyping. It has shown that prototyping is a useful 
adjunct to the systems development life cycle and is most 
appropriately applied to Management Information System 
applications. The most significant contribution of 
prototyping is the establishment and maintenance of 
effective communications with the user during system 
development. 

This thesis has shown the inportance of having a data 
dictionary mechanism to capture the output of prototyping. 
Further, it has explained metadata and its importance in 
building a system and understanding both the user’s 
requirements and project management’s requirements. Clearly 
metadata, like user data, must be organized into a database, 
a data dictionary system. Organization of a data dictionary 
can be in accordance with one of many different data models, 
but the relational offers the mcst promise for future use. 
Consequently, the thesis includes a prototype relational 
dictionary system. 

The dictionary system demonstrates the feasibility of 
using : 

1. the relational model for a data dictionary. 

2. micro-computers in a prototype effort. 

Although of limited functionality, the prototype was quickly 
developed and offers considerable flexibility in its struc- 
ture to serve as an on-going aid in developing the data 
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administration function in the user’s organization. DDICT 
II is living proof of the viability of prototyping with data 
dictionaries as a means of organizing and understanding the 
data and user’s needs in system development. 
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APPENDIX A 



OSER MANUAL 



A. INTRODUCTION 

This manual explains only what is necessary to get 
started using the system. The system is self-prompting and, 
therefore, an extended narrative is unnecessary. This 
manual explains the use of both the demonstration system and 
the actual dictionary. The demonstration system resides on 
floppy disks and requires a different initialization 
procedure. If you are using the demonstration system, 
proceed to the next section. If you want to use the actucLL 
installed dictionary, skip to section C. After 
initialization both systems operate identically so, upon 
completing initialization, proceed to section D, MAIN menu. 

B. INITIALIZING THE DEMONSTRATION SYSTEM 

1. If the system is on, turn it off and remove all 
floppy disks. 

2. Insert the floppy disk marked 'dBASE II’ into drive A 
and the floppy marked ’DEMONSTRATION' into drive B. 

3. Turn on the system (all components: computer, monitor 
and printer) . 

4. Upon being prompted for the date, you may enter it in 
the general form: HM-DD-YY , or simply strike the 
RETURN key. The same is true for the following prompt 
for the time. If you wish to have the current time 
available to the system, the general form of your 
reply is: HH:MM 

5. Upon correctly answering the time and date prompts 
you will receive the following on the screen: 
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A> 

6. Now type in ’DBASE* and hit the RETOEN key. 

7. You will hear the 'A' disk drive whirr and its light 
come on. After a few seconds a message will appear: 

Copyright (C) 1982 RSP Inc. *** dBASE 11/86 Ver 2.4 

I July 1983 

The blinking underline character following the period 
is the cursor. The period is the prompt used by dBASE 

II and indicates that you have accessed the dBASE II 
software. 

8. You should now type the following in response to the 
prompt: 

SET DEFAULT TO B: 

9. Upon receiving the period prompt you are now ready to 
use the demonstration version of the data dictionary. 
At this point proceed to section D, MAIN menu. 

C. INITIALIZING THE INSTALLED DICTIONARY 

This manual assumes that the user is familiar with the 
IBM PC sufficiently to start it up and move to the 
appropriate working directory upon which the dictionary 
system is installed. For the purpose of this manual it 
assumes that directory (disk drive) is C. Once you have 
moved to that disk you are ready to start up the dbase II 
software. At this point type in "dbase” and then hit the 
RETURN key. You will hear the "C" disk drive whirr and its 
light come on. After a few seconds a message that reads as 
follows will appear: 
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Copyright (C) 1982 RSP Inc. *** dBASE 11/86 Ver 2.4 1 July 

1983 



The blinking underline character following the period is the 
cursor. The period is the prompt for dBASE II and indicates 
that you have the accessed dBASE II software. Upon 
receiving the period prompt you are now ready to use the 
actual version of the data dictionary. Proceed to the next 
section, MAIN menu. 

D. HATH HENO 

Type in the following and the main menu for the data 
dictionary will appear: DO MAIN (all capital letters aren't 
necessary, but it's best for this particular system to set 
the "caps lock" key so that you are always in uppercase. To 
set the "caps lock" key just strike the key so marked once) . 

The MAIN menu permits selection of the major function 
you wish to perform. Upon selecting a major function, enter 
the number associated and another menu will appear. Please 
wait for the "WAITING" message to appear before typing the 
number of the major function you want. Upon selecting a 
major function another menu will appear (See example of the 
Main Menu on the next page) . Use the instructions of this 
manual for working with those menus. After a period of use 
you will become familiar with the specific functions of the 
system, such as adding a model record. If you find the use 
of the menus tedious at that time, you can execute any 
specific program by entering "DC program name". For 
example, to directly execute the program to change an office 
record you would enter "DO CHG-CFFICE". To help you learn 
the specific program names they are provided in the menus in 
parentheses beside the explanation of a choice. This means 
that once you have the period prompt mentioned above, you 
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can directly accomplish a particular function by executing 
the associated program and not stepping through the menus. 

This is the MAIN menu for the data dictionary system. 

The system allows you to add, change, or delete records and 
to process queries. Please enter the number of the function 
you wish to perform: 



Enter the selection here 
WAITING 

E. ADD SUBSYSTEM 

There are two methods of accessing the ADD-MENU; either 
by typing in the command ’DO ADD-MENU' or by selecting 
option #1 from the MAIN-MENU. In either case, the following 
menu will appear: 



0 to quit 



1 add a new record 

2 change a record 

3 delete a record 
h run a query 



(ADD-MENU) 

(CHG-MENU) 

(DEL-MENU) 

(QERY-HENU) 

(REPT-MENU) 



5 print a report 



ADD MENU 



0 to quit 



1 Model (ADD-MODEL) 



5 File (ADD-FI) 



2 Office (ADD-OFFICE) 



6 Element (ADD-EL) 



3 Report (ADD-REP) 

4 Program (ADD-PRO) 



7 Field (ADD-FE) 

8 Alias (ADD-AL) 



9 Category (ADD-CAT) 



Enter the selection here 



WAITING 0 
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Selecting 0 from the ADD-MEND will return you to either 
the MAIN-MEND or a blank screen (if the ’DO ADD- MEND’ 
command was used). 

To add a new record, press the number associated with 
the entity’s type. The system will prompt you for the unique 
name of the entity you wish to add. If that name is not 
truly unique, the system will tell you so and not permit you 
to add a new record. If the name is unique a screen will 
appear with the fields highlighted to include blank spaces 
for entering data for the new record. Simply fill in the 
appropriate data items and move from field to field (DSING 
THE CDRSOB) until you have filled in all the blank fields 
for which you have data. Once you have assured yourself 
that all data items you have entered are correct, hit the 
EETDRN key and the record will he added to the database. 

(Note: after the RETDRN key has been hit changes can only be 
made using the CHANGE subsystem) 

Once you have entered a record by hitting the RETDRN key 
you will be prompted if you wish to add another record to 
the database. To stop adding records, hit the space bar and 
RETURN. As soon as the RETURN key is hit you will be 
returned to either the ADD-MENU or the dbase II system. 

F. CHANGE SDBSYSTEH 

There are two methods of accessing the CHANGE menu , 
either typing in the command "DC CHG-MENO" and striking the 
return key or selecting option 2 from MAIN menu. In either 
case tie CHG menu will appear as follows: 

This is the CHANGE menu. It permits you to change records in 
any file. Please enter the number of the function you wish to 
perform. 

0 to quit 

1 Model (CHG-MODEL) 5 Pile (CHG-FI) 
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2 Office (CHG-OFFICE) 6 Zlement (CHG-EL) 

3 Report (CHG-EEP) 7 Field (CHG-FE) 

4 Program (CHG-PRO) 8 Alias (CHG-AL) 

9 Category (CHG-CAT) 



Enter the selection here 
WAITING 

When selecting from the menu always wait for the system to 
prompt you with the words "WAITING'*. Selecting 0 will 
return you to either the MAIN menu or a blank screen (if the 
"DO CHG-MENU" command was used) - 

Regardless of whatever type entity you wish to change, 
the system will require you to provide the entity's unique 
name. To quit changing records, hit the space bar and 
RETURN. The system will then find the record for that 
entity and present it on the screen for editing. Having 
completed the editing, the record can be stored back in the 
dictionary by moving the cursor down through the last field 
using the RETURN key. If there are any relationships for 
which the entity is an object of, the particular program you 
are using will prompt you if you wish to add or delete 
entities associated with the one you just changed. For 
example, if you edited the record for a particular FIELD, 
then the system will prompt you if you wish to add or delete 
verbal type records for ELEMENTS that contain the FIELD. A 
change in the unique name of an entity will be automatically 
changed in all verbal type records for you by the software. 
For example, if you changed the unique name of a FIELD the 
software will change all CONTAINS records accordingly for 
you. 



69 



G. DELETE SOBSISTEH 



There are two methods of accessing the DELETE menu , 
either typing in the command "DO DEL-MENU" and striking the 
return key or selecting option 3 from MAIN menu. In either 
case the DELETE menu will appear as follows: 

This is the DELETE menu. It permits you to delete records 
from any file. Please enter the number of the function you 
wish to perform. 



0 to quit 



1 Model (DEL-MODEL) 

2 Office (DEL-OFPICE) 

3 Report (DEL-HEP) 

4 Program (DEL-PRO) 



5 File (DEL-FI) 

6 Element (DEL-EL) 

7 Field (DEL-FE) 

8 Alias (DEL-AL) 

9 Category (DEL-CAT) 



Enter the selection here 
WAITING 

Select the type entity you wish to delete by entering the 
number associated with the entity’s type. The particular 
program selected will prompt you for the unique name of the 
entity. To quit deleting records, hit the space bar and 
RETURN, otherwise type in the name and hit RETURN. If you 
have given the unique name correctly, the system will find 
that entity’s record and ask if you are sure that is the one 
you wish to delete. If you answer Y, the system will delete 
the associated record, not merely mark it for deletion. 
Further, the system will automatically delete all associated 
verbal type records for the particular entity deleted. For 
example, if you chose to delete the FIELD named Grade, and 
that field is contained in the ELEMENT Aspec, then all the 
CONTAIN records showing Aspec as containing the field will 
also be deleted. 
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H. QOEEY SOBSYSTEH 



There are two methods of accessing the QUERY menu, 
either by typing in the command "DO REPT-MENU" and striking 
the return key or selecting option 4 from the M&IN menu. In 
either case the QUERY menu will appear as follows: 

This is the QUERY menu. It permits you to make 
ad-hoc inguiries. Queries are either of the 
’forward’ type where an entity is the subject and 
you specify the verb and object, or of the ’backward’ 
type where the entity you give is the object of an 
action and subject. 

QUERY MENU 

1) Forward type (i.e. P3M calls what programs ?) (FORTREV) 

2) Backward type {i.e. P3M is used by what offices ?) (BAKTREV) 

3) Forward type for aliases ( indicate type and system 
provides all aliases) (FORAl) 

4) Backward type for aliases (give entity name and system 

(BAKAL) provides all aliases for that particular entity) 

5) Forward type for categories (indicate type and system 

gives categories) (FORCAT) 

6) Backward type for categories (give entity name and 
(BAKCAT) system gives all categories that entity is in) 

0 to quit 

Enter the selection here 
WAITING 0 

The system provides two types of queries, forward and 
backward. Forward means the user is presented columns of 
relations from which to pick. The columns, following the 
forward flow of the English language, are subject, verb and 



object respectively. The user provides the unique name of 
the entity beside its type in the subject column; then marks 
one appropriate entry in the verb column and one 

appropriate entry in the object column. For example, to 

answer the question ''What models does the office with symbol 
DAPC-PLF use ?" see Figure A. 1 which depicts how the screen 
of the FORTREV program would appear and Figure A. 2 depicts 
the output. Verb and object choices must be appropriate for 
the subject in that it is not possible to get any response 
from a query marked for which there is no relationship 
defined. For example, marking the screen of the FORTREV 
program to answer the question ”What models contain what 
fields ? " would elicit no response when processed. 



SUBJECTS 



VERBS 



OBJECTS 



Office:DAPC-PLF : Uses:X: 

Maintains: : 

Model: : Calls: : 

Inputs: : 
Outputs: : 

File: : 

Contains: : 

Element: : 

To quit put an X in this field 



Reports: : 
Models:X : 

Programs: : 
Files: : 



Elements: : 
Fields: : 



Put the unique name of the entity you are querying about 
in the field next to the entity's type. Then place an X 
in one appropriate verb field for that entity type and 
an X in 1 appropriate object field. 

I.E. Office :DAPC-P1F : Uses:X: Models:X: 

To process query move cursor through remaining 
fields using RETURN key. 



Figure A.1 Example of a Forward Retrieval 
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T 



The office DAPC-PIF uses the following models 

P3M 

OAS 

Strike any key to continue. . . 

WAITING 



Figure A. 2 Example of Forward Query Output 

The backwards approach is implemented by presenting, 
from left to right, columns ot objects, verbs and then 
subjects. Thus, to answer a guestion such as ’*What offices 
use the P3M model ?•' the screen of the BAKTREV program 
would be marked as shewn in Figure A. 3 and Figure A. 4 
depicts how the output from this guery would appear. 

Because the ALIAS and CATEGORY relations are each a special 
case, they are given their own respective forward (FORAl S 
FORCAT) and backward (BAKAL & BAKCAT) guery programs. 

I. BEPOBTS SOBSYSTEH 

There are two methods of accessing the REPORT menu, 
either by typing in the command "DO REPT-NENU" and striking 
the RETOBN key or selecting option 5 from the MAIN menu. In 
either case the menu will appear as follows: 
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OBJECTS 



VERBS 



SUBJECTS 



Model: P3M 
Report: 



Is used by:X: 
: Is maintaiced by: : 



Office: X: 



Program: 

File: 



Is called by: 
Is inputted by: 
Is outputted by: 



Model: : 



Element: 

Field: 



File 



Is contained in: : 



Element 



To quit put an X in this field: : 

Enter the name of the entity besides its type and then 
mark 1 verb field and 1 subject field. To process 
query move cursor down through remaining fields 
using RETURN key. 



Figure A. 3 Example of a Backward Retrieval 



I 1 



The model P3M is used by the following offices 

DAPC-PLP 

DAPC-PLT 

DAPC-PLS 

DAPC-PLF 

Strike any key to continue . .. 

WAITING 



j 



Figure A. 4 Output From a Backwards Query 
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This is the EEPORT menu. It permits you to print 
summary reports from the dictionary. 

REPOET MENU 

1) for a specific Model all users, maintainers, 
input 6 output files, programs called (SUMOD) 

2) for a specific Report all users and models outputting it 

(SUMREP) 

3) for a specific Office all models used, all 
models maintained, and reports used. (SUMOFF) 

4) for a specific File all models it provides input to, 
receives output from, and elements it contains (SUMFIL) 

0 to guit 

Enter the selection here 
WAITING 

Before executing any Report menu option be sure the 
printer is both turned on and is "on line". Failure to have 
the printer turned on may result in your being thrown out of 
the data dictionary system and dBASE II and, therefore, to 
reinitialize. Select the report program you wish to 
execute. The system will then prompt you for the unique name 
of the entity concerned. For that specific entity, the 
system will then provide a printed summary report which 
provides all entities which have a direct relationship with 
the entity. Thus, if the you provide the unique name of a 
Model, the printed report would list: 

1. All offices which use the Model. 

2. All offices which maintain the Model. 

3. All programs the Model calls. 
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4. All reports the Model outputs. 

5. All files the Model either inputs from or outputs to. 
For example, if you wished to have a summary report about 
for the P3M model you would select option 1 from the Reports 
menu for execution of the SOMOD program. The system would 
then prompt you as follows: 

Please enter the unigue name of the Model 
Hit the space bar and RETURN to guit;P3H 



The Model P3 M 

Is used by the following offices; 

DAPC-PLP 

DAPC-PLT 

DAPC-PIS 

DAPC-PLF 

Is maintained by the following offices with 
the point of contact: 

DAPC-PIF KALINICH 

Inputs the following files: 

P3MDATA 

Outputs to the following files: 

P3M0UTPUT1 

Outputs the following reports: 

EPHE 

P3MEEP1 

Calls the following programs 

P3MPR0GUN01 

P3MPR0GD0S1 

P3MPR0GTRES1 

Strike any key to continue 
WAITING 



Figure A. 5 Example of Report Output 
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J. TEBIIHATIBG A SESSION 



Having completed whatever work you wished to accomplish, 
you will now want to shut down the dictionary system. 

1. If you have a menu up on the screen, select "0" and 
exit. If another menu appears, exit in the same 
manner. You will now have the period prompt on the 
screen indicating you are out of the dictionary 
system. 

2. Type in the word "QiJIT” and hit the RETaRW key. 

3. If you are using the demonstration system you will 
get the following prompt: 

A> 

If you are using the installed system you will get 
the following prompt: 

C> 

4. If you were using the installed system, turn off the 
machine and you are done. If you were using the 
demonstration system, remove the floppy disks and 
store them in their paper sleeves. 
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APPENDIX B 

DATA DICTIOHARI SYSTEM'S DATA ELEMENTS 



The following is an alphabetic listing of the fields 
used in the dictionary system. An asterisk following a file 
name denotes the field being discussed as being key to that 
file. 

dBASE II FIELD NAME / ACRONYM: aname 

FULLNAME: alias name 
FORMAT: mixed 
LENGTH: 15 

FILES WHERE USED: Alias 

DESCRIPTION: Name by which any entity is known 
other than its official name. 



dBASE II FIELD NAME / ACRONYM: bldg 

FULLNAME: building 
FORMAT: mixed 
LENGTH: 15 

FILES WHERE USED: Office 

DESCRIPTION: The building in which an office 
is located. 

dBASE II FIELD NAME / ACRONYM: cat 
FULLNAME: category 
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FORMAT: alphabetic 
LENGTH: 16 

FILES HHERE USED: Category 

DESCRIPTION: The category in which an 
entity would be placed such as a field being a 
continuation rate. 



dSASE II FIELD NAME / ACRONYM: comments 
FULLNAME: comments 
FORMAT: mixed 
LENGTH: 45 

FILES WHERE USED: office 

DESCRIPTION: Any narrative information 
that illuminates on the office cccuring 
in the record. 

dBASE II FIELD NAME / ACRONYM: datatype 

FULLNAME: datatype 
FORMAT: alphabetic 
LENGTH: 3 

FILES WHERE USED: Field 

DESCRIPTION: The type of data that a field could 
hold. The entry can be either A for alphabetic, 

N for numeric, AN for both or S for special. 

For example, for a field that could hold all three 
this entry would be ANS- 

dBASE II FIELD NAME / ACRONYM: date 
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FULL NAME; date 



FORMAT; numeric 
LENGTH; 6 

FILES WHERE USED; Element 

DESCRIPTION; This is date an element was created. 
dBASE II FIELD NAME / ACRONYM; description 
FULLNAHE; description 
FORMAT; alphabetic 
LENGTH; as 

FILES WHERE USED; Report, Model, Program, 

File, Element, Field 

DESCRIPTION; Verbal narrative illuminating on the 
entity it is associated with. 

dBASE II FIELD NAME / ACRONYM; domain 
FULLNAMS: domain 
FORMAT; mixed 
LENGTH: 45 

FILES WHERE USED: Field 

DESCRIPTION: The range of acceptable values 
a field can take on. 

dBASE II FIELD NAME / ACRONYM; editcri 
FULLNAME; edit criteria 
FORMAT; mixed 
LENGTH; 45 
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FILES WHERE OS ED: Field 



DESCRIPTION: Rules used to constrain and 
edit what values can occur in a field. 



dBASE II FIELD NAME / ACRONYM: elname 

FULLNAME: element name 
FORMAT: mixed 
LENGTH: 12 

FILES WHERE USED: Element* 

DESCRIPTION: Unique name of file element (not a data 
element or field, but the partition of a file). 

dBASE II FIELD NAME / ACRONYM: ename 

FULLNAME: entity name 

FORMAT: mixed 

LENGTH: 15 

FILES WHERE USED: Alias*, Category*, Contains, 

Calls, Uses, Outputs, Inputs, Alias 

DESCRIPTION: The unicue name associated with an 
entity such as what could legally occur in mdl 
for a Model. This value would be the object 
of one of the verb relations. 

dBASE II FIELD NAME / ACRONYM: enamel 

FULLNAME: entity name #1 

FORMAT: mixed 

LENGTH: 15 
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PILES WHERE DSED: contains*. Outputs*, Inputs*, 
Calls* 

DESCRIPTION: The unique name associated with an 
entity and the subject of a vert relation. 



dBaSE II FIELD NAME / ACRONYM: etype 
FULLNAME: entity type 
FORMAT: alphabetic 
LENGTH: 10 

FILES WHERE USED: Contains, Outputs, Inputs, 
Calls 

DESCRIPTION: Type of entity that ename 
specifies such as Model, Report, etc. 

dEASE II FIELD NAME / ACRONYM: etypel 
FULLNAME: entity type #1 
FORMAT: alphabetic 
LENGTH: 10 

FILES WHERE OSED: Contains*, Outputs*, Inputs*, 
Calls* 

DESCRIPTION: Type of entity that enamel is 
specifying such as Model, Report, etc. 

dBASE II FIELD NAME / ACRONYM: fid 

FULLNAME: field 
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FORMAT: mixed 



LENGTH: 15 

FILES WHERE USED: Field* 

DESCRIPTION: The unique name of a field. 

dBASE II FIELD NAME / ACRONYM: fname 

FULLNAME: file name 
FORMAT: mixed 
LENGTH: 16 

FILES WHERE DSED: File* 

DESCRIPTION: The unique name of a file. 

dBASE II FIELD NAME / ACRONYM: fullname 
FULLNAME: full name 
FORMAT: mixed 
LENGTH: 25 

FILES WHERE USED: Report, File 

DESCRIPTION: The non-unique and fully expanded 
name of either a report or file. 

dBASE II FIELD NAME / ACRONYM: language 

FULLNAME: language 
FORMAT: mixed 
LENGTH: 10 

FILES WHERE DSED: Program 
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DESCRIPTION; The computer language 
a program is written in, such as 
FORTRAN 77. 

dBASE II FIELD NAME / ACRONYM: Istupdate 

FDLLNAME; last update 
FORMAT: numeric, YYMMDD 
LENGTH: 6 

FILES WHERE USED: File 

DESCRIPTION: The most recent date of 
a file having been updated. 

dBASE II FIELD NAME / ACRONYM: length 
FULLNAHE: length 
FORMAT: numeric 
LENGTH: 3 

FILES WHERE USED: Field 

DESCRIPTION: The size of a field in bytes. 

dBASE II FIELD NAME / ACRONYM: location 

FULLNAME: location 
FORMAT: mixed 
LENGTH: 16 

FILES WHERE USED: Model, Program 
DESCRIPTION: The file where a program or model 
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is stored on the computer. 

dBASE II FIELD NAME / ACRONYM: ttdl 

FULLNAME: model 

FORMAT: mixed 

LENGTH: 8 

FILES WHERE USED: Model*, Maintains* 

DESCRIPTION: The unique abbreviation or acronym 
associated with a Model. 

dBASE II FIELD NAME / ACRONYM: media 

FULLNAME: Storage media 
FORMAT: alphabetic 

LENGTH: 10 

FILES WHERE USED: File 

DESCRIPTION: The type medium used to store 

a file, i.e. tape or disk. 

dBASE II FIELD NAME / ACRONYM: method 
FULLNAME: methodology 
FORMAT: alphabetic 
LENGTH: 45 

FILES WHERE USED: Model 

DESCRIPTION: The Operations Research solution 
techniques used by a model such as Linear Programming. 
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dBASE II FIELD NAME / ACRONYM: aodelpoc 

FOLLNAME: model point of contact 
FORMAT: alphabetic 
LENGTH: 15 

FILES WHERE USED: Maintains 

DESCRIFTICN: The individual to te contacted 
regarding maintanance of a model. 

dBASE II FIELD NAME / ACRONYM: BOdname 

FULLNAME: model name 
FORMAT: mixed 
LENGTH: 30 

FILES WHERE USED: Model 

DESCRIPTION: The fully expanded, non-unique 
name of a Model. 



dBASE II FIELD NAME / ACRONYM: nullstat 

FULLNAME: nullstatus 
FORMAT: alphabetic 
LENGTH: 1 

FILES WHERE USED: Field 

DESCRIPTION: Indicates whether a field can have 
the null status or some value must always be 
present. 

dBASE II FIELD NAME / ACRONYM: number 
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FQLLNAME: number 



FORMAT; mixed 
LENGTH; 9 

FILES WHERE OS ED; Office 

DESCRIPTION; The number assigned to a report by 
the computer operations organization of MILPERCEN. 

dBASE II FIELD NAME / ACRONYM; cfc 

FULLNAME; office symbol 

FORMAT; alphabetic 

LENGTH; 9 

FILES WHERE DSED; Office*, Dses* 

DESCRIPTION; The unique symbol which identifies 
an office of either DCSPLANS or some other 
organization, for example PERSINSD. 

dBASE II FIELD NAME / ACRONYM: cname 

FULLNAME: office name 

FORMAT: mixed 

LENGTH: 35 

FILES WHERE USED: File 

DESCRIPTICN; The expanded, non-unique name of an 
office, such Deputy Chief of Staff for Plans 
for DCSPLANS. 

dBASE II FIELD NAME / ACRONYM; outfrmat 
FULLNAME; output format 
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FORMAT: alphabetic 
LENGTH: 15 

FILES WHERE USED: Report 

DESCRIPTION: The form a report takes such as hard copy, 
tape, or microfice. 

dBASE II FIELD NAME / ACRONYM: phone 

FULLNAME: telephone number 
FORMAT: mixed 
LENGTH: 21 

FILES WHERE USED: Office 

DESCRIPTION: The telephone number of an office. 
dBASE II FIELD NAME / ACRONYM: pname 

FULLNAME: program name 

FORMAT: alphabetic 

LENGTH: 15 

FILES WHERE USED: Program* 

DESCRIPTION: The unique identifier of a program. 

dBASE II FIELD NAME / ACRONYM: periodicity 

FULLNAME: periodicity of entity 
FORMAT: mixed 
LENGTH: h 

FILES WHERE USED: Report, Model, Program 

DESCRIPTION: How frequently a report, program, 
or model is executed or produced. Coded by 
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a number and then the time period. For example, 

2W means twice monthly, 3Q means thrice quarterly. 

dBASE II FIELD NAME / ACRONYM: poc 

FULL NAME; point of contact 
FORMAT: alphabetic 
LENGTH: 15 

FILES ffHERE USED: Office, File, Element, and 
Field 

DESCRIPTION: The individual to be contacted if 
having problems or need information about 
the associated entity. 

dBASE II FIELD NAME / ACRONYM: purpose 

FULLWAME: purpose 
FORMAT: alphabetic 
LENGTH: 45 

FILES WHERE USED: Report, Model, Program, 

File, Field, and Element 

DESCRIPTION: The function and reason for 
existence of an entity. 

dBASE II FIELD NAME / ACRONYM: rname 

FULLHAME: report name 
FORMAT: mixed 
LENGTH; 10 

FILES WHERE USED: Report* 
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DESCRIPTION: The unique identifier of a Report. 
dBASE II FIELD NAME / ACRONYM: seqnum 
FULLNAME: sequence number 
FORMAT: numeric 
LENGTH: 5 

FILES HnERE OSED: Element 

DESCRIPTION: Location of an element within 
the file that holds it. Elements are 
both named and marked by their sequential 
position in the file. 

qBASE II FIELD NAME / ACRONYM: room 

FULLNAME: room number 

FORMAT: mixed 

LENGTH: 6 

FILES WHERE USED: Office 

DESCRIPTION: Room where an office is located. 

dBASE II FIELD NAME / ACRONYM: runame 

FULLNAME: run stream name 
FORMAT: mixed 
LENGTH: 15 

FILES WHERE USED: Model 

DESCRIPTION: The unique name of a rui stream (Job 
Control Language procedure) that results in 
Model being executed. 
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dBASE II FIELD NAME / ACEONYM: size 



FULLNAME; size 
FORMAT: numeric 
LENGTH: 3 

FILES WHERE OSSD: Element 

DESCRIPTION: Length in bytes of an occurrence in an 
element. All occurrences in an element are the same size 
and the format of the element is likened to a record. 

dBASE II FIELD NAME / ACEONYM: seclass 

FULLNAME: security classif icaticn 

FORMAT: alphabetic 

LENGTH: 2 

FILES WHERE USED: Report, Field 

DESCRIPTION: Highest level of classified 
information the entity contains. Coded 
as 0, C, S or TS. 

dBASE II FIELD NAME / ACRONYM: source 
FULLNAME: source 
FORMAT: mixed 
LENGTH: 15 

FILES WHERE USED: Field 

DESCRIPTION: The document or source 
which explains or specifies what values 
can occur in a field. For example, 

AR 611-201 specifies what would occur in a 



field for enlisted military occupational 
specialty. 

dBaSE II FIELD NAME / ACRONYM: status 
FULLNAME: development status 
FORMAT: alphabetic 
LENGTH: 15 

FILES WHERE USED: Report, Model, Program, 

File, Field 

DESCRIPTION: The development status of an entity such as 
test, operational, retired. 

dBASE II FIELD NAME / ACRONYM; version 

FULLNAME: version 

FORMAT: numeric 

LENGTH: 3 

FILES WHERE USED: Program* 

DESCRIPTION: The edition number f a program and 
therefore an indicator of unigue..ass. For example, 
ADSPEC3. 
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DATA DICTIONARY SOOfiCE LISTING 
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to permit user to add a new report record to dictionary 
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add-program, prg 



to add a new program record to dictionary 
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accept To guit entering Models hit the space bar and RETURN to amoff 
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To guit hit space bar and then RETURN for the following prompt 
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dfiomod.prg delete models in output file that produce a preexsisting file 
purpose: delete models in output file that produce a preexisting file 
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need to add new elements that contain this field 
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if trim (ename) = trimfamfld) .and. trim(etype) = 'FIELD* .and. 
trim (enamel ) = ! (amoff) 

delete 

endif 
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store file data into memory variables for editing in screen 
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check to delete models from outputs file that used to output file 
'Do you wish to delete a Model that outputs this report ?' 

cept 'If so enter a Y and RETORN, else hit the space bar and RETDRN' to a nswr 
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Enter the symbol for the office using this report and RETDRN 
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while flag 



arout.prg to add model that outputs a preexisting report 
to add model to outputs file for a preexisting report 
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user to change an office record 
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apmod.prg to add models in calls file for preexisting program records 
purpose: to add models in calls file for preexisting program records 
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Program: name del-category 



to delete category records from dictionary 
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ACCEPT ENTER THE FIELD’S UHIQDE NAME PLEASE TO DHNUM 
ER AS E 

* This locates the exact record 
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REMARK STANDBY WHILE I PERFORM MAINTENANCE ON ASSOCIATED FILES 
♦ actually remove records marked for deletion above 
USE CONTAINS 
PACK 
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to delete model records from dictionary 
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GOOD BYE FROM THE DELETE MODEL PROGRAM 
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name del-alias 

to delete alias records from dictionary 
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isplay enamel for trim (ename) = trim (go : file) .and. trim(etype) 
FILE’ .and. trim(etypei) = 'MODEL' off 
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if q variable nonblank, load appropriate words to type variable and and 
approprxate words to query variable for display command later 
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